<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Chapter 28. Zend_Measure</title>
<link rel="stylesheet" href="dbstyle.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="Programmer's Reference Guide">
<link rel="up" href="index.html" title="Programmer's Reference Guide">
<link rel="prev" href="zend.mail.read.html" title="27.14. Reading Mail Messages">
<link rel="next" href="zend.measure.creation.html" title="28.2. Creation of Measurements">
<link rel="chapter" href="introduction.html" title="Chapter 1. Introduction to Zend Framework">
<link rel="chapter" href="zend.acl.html" title="Chapter 2. Zend_Acl">
<link rel="chapter" href="zend.auth.html" title="Chapter 3. Zend_Auth">
<link rel="chapter" href="zend.cache.html" title="Chapter 4. Zend_Cache">
<link rel="chapter" href="zend.config.html" title="Chapter 5. Zend_Config">
<link rel="chapter" href="zend.console.getopt.html" title="Chapter 6. Zend_Console_Getopt">
<link rel="chapter" href="zend.controller.html" title="Chapter 7. Zend_Controller">
<link rel="chapter" href="zend.currency.html" title="Chapter 8. Zend_Currency">
<link rel="chapter" href="zend.date.html" title="Chapter 9. Zend_Date">
<link rel="chapter" href="zend.db.html" title="Chapter 10. Zend_Db">
<link rel="chapter" href="zend.debug.html" title="Chapter 11. Zend_Debug">
<link rel="chapter" href="zend.dojo.html" title="Chapter 12. Zend_Dojo">
<link rel="chapter" href="zend.dom.html" title="Chapter 13. Zend_Dom">
<link rel="chapter" href="zend.exception.html" title="Chapter 14. Zend_Exception">
<link rel="chapter" href="zend.feed.html" title="Chapter 15. Zend_Feed">
<link rel="chapter" href="zend.filter.html" title="Chapter 16. Zend_Filter">
<link rel="chapter" href="zend.form.html" title="Chapter 17. Zend_Form">
<link rel="chapter" href="zend.gdata.html" title="Chapter 18. Zend_Gdata">
<link rel="chapter" href="zend.http.html" title="Chapter 19. Zend_Http">
<link rel="chapter" href="zend.infocard.html" title="Chapter 20. Zend_InfoCard">
<link rel="chapter" href="zend.json.html" title="Chapter 21. Zend_Json">
<link rel="chapter" href="zend.layout.html" title="Chapter 22. Zend_Layout">
<link rel="chapter" href="zend.ldap.html" title="Chapter 23. Zend_Ldap">
<link rel="chapter" href="zend.loader.html" title="Chapter 24. Zend_Loader">
<link rel="chapter" href="zend.locale.html" title="Chapter 25. Zend_Locale">
<link rel="chapter" href="zend.log.html" title="Chapter 26. Zend_Log">
<link rel="chapter" href="zend.mail.html" title="Chapter 27. Zend_Mail">
<link rel="chapter" href="zend.measure.html" title="Chapter 28. Zend_Measure">
<link rel="chapter" href="zend.memory.html" title="Chapter 29. Zend_Memory">
<link rel="chapter" href="zend.mime.html" title="Chapter 30. Zend_Mime">
<link rel="chapter" href="zend.openid.html" title="Chapter 31. Zend_OpenId">
<link rel="chapter" href="zend.paginator.html" title="Chapter 32. Zend_Paginator">
<link rel="chapter" href="zend.pdf.html" title="Chapter 33. Zend_Pdf">
<link rel="chapter" href="zend.registry.html" title="Chapter 34. Zend_Registry">
<link rel="chapter" href="zend.rest.html" title="Chapter 35. Zend_Rest">
<link rel="chapter" href="zend.search.lucene.html" title="Chapter 36. Zend_Search_Lucene">
<link rel="chapter" href="zend.server.html" title="Chapter 37. Zend_Server">
<link rel="chapter" href="zend.service.html" title="Chapter 38. Zend_Service">
<link rel="chapter" href="zend.session.html" title="Chapter 39. Zend_Session">
<link rel="chapter" href="zend.soap.html" title="Chapter 40. Zend_Soap">
<link rel="chapter" href="zend.test.html" title="Chapter 41. Zend_Test">
<link rel="chapter" href="zend.text.html" title="Chapter 42. Zend_Text">
<link rel="chapter" href="zend.timesync.html" title="Chapter 43. Zend_TimeSync">
<link rel="chapter" href="zend.translate.html" title="Chapter 44. Zend_Translate">
<link rel="chapter" href="zend.uri.html" title="Chapter 45. Zend_Uri">
<link rel="chapter" href="zend.validate.html" title="Chapter 46. Zend_Validate">
<link rel="chapter" href="zend.version.html" title="Chapter 47. Zend_Version">
<link rel="chapter" href="zend.view.html" title="Chapter 48. Zend_View">
<link rel="chapter" href="zend.xmlrpc.html" title="Chapter 49. Zend_XmlRpc">
<link rel="appendix" href="requirements.html" title="Appendix A. Zend Framework Requirements">
<link rel="appendix" href="coding-standard.html" title="Appendix B. Zend Framework Coding Standard for PHP">
<link rel="appendix" href="copyrights.html" title="Appendix C. Copyright Information">
<link rel="index" href="the.index.html" title="Index">
<link rel="section" href="zend.measure.html#zend.measure.introduction" title="28.1. Introduction">
<link rel="section" href="zend.measure.creation.html" title="28.2. Creation of Measurements">
<link rel="section" href="zend.measure.output.html" title="28.3. Outputting measurements">
<link rel="section" href="zend.measure.edit.html" title="28.4. Manipulating Measurements">
<link rel="section" href="zend.measure.types.html" title="28.5. Types of measurements">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader"><table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">Chapter 28. Zend_Measure</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="zend.mail.read.html">Prev</a> </td>
<th width="60%" align="center"> </th>
<td width="20%" align="right"> <a accesskey="n" href="zend.measure.creation.html">Next</a>
</td>
</tr>
</table></div>
<div class="chapter" lang="en">
<div class="titlepage"><div><div><h2 class="title">
<a name="zend.measure"></a>Chapter 28. Zend_Measure</h2></div></div></div>
<div class="toc">
<p><b>Table of Contents</b></p>
<dl>
<dt><span class="sect1"><a href="zend.measure.html#zend.measure.introduction">28.1. Introduction</a></span></dt>
<dt><span class="sect1"><a href="zend.measure.creation.html">28.2. Creation of Measurements</a></span></dt>
<dd><dl>
<dt><span class="sect2"><a href="zend.measure.creation.html#zend.measure.creation.number">28.2.1. Creating measurements from integers and floats</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.creation.html#zend.measure.creation.string">28.2.2. Creating measurements from strings</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.creation.html#zend.measure.creation.localized">28.2.3. Measurements from localized strings</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="zend.measure.output.html">28.3. Outputting measurements</a></span></dt>
<dd><dl>
<dt><span class="sect2"><a href="zend.measure.output.html#zend.measure.output.auto">28.3.1. Automatic output</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.output.html#zend.measure.output.value">28.3.2. Outputting values</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.output.html#zend.measure.output.unit">28.3.3. Output with unit of measurement</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.output.html#zend.measure.output.localized">28.3.4. Output as localized string</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="zend.measure.edit.html">28.4. Manipulating Measurements</a></span></dt>
<dd><dl>
<dt><span class="sect2"><a href="zend.measure.edit.html#zend.measure.edit.convert">28.4.1. Convert</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.edit.html#zend.measure.edit.add">28.4.2. Add and subtract</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.edit.html#zend.measure.edit.equal">28.4.3. Compare</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.edit.html#zend.measure.edit.compare">28.4.4. Compare</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.edit.html#zend.measure.edit.changevalue">28.4.5. Manually change values</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.edit.html#zend.measure.edit.changetype">28.4.6. Manually change types</a></span></dt>
</dl></dd>
<dt><span class="sect1"><a href="zend.measure.types.html">28.5. Types of measurements</a></span></dt>
<dd><dl>
<dt><span class="sect2"><a href="zend.measure.types.html#zend.measure.types.binary">28.5.1. Hints for Zend_Measure_Binary</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.types.html#zend.measure.types.decimal">28.5.2. Hints for Zend_Measure_Number</a></span></dt>
<dt><span class="sect2"><a href="zend.measure.types.html#zend.measure.types.roman">28.5.3. Roman numbers</a></span></dt>
</dl></dd>
</dl>
</div>
<div class="sect1" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="zend.measure.introduction"></a>28.1. Introduction</h2></div></div></div>
<p>
        <code class="code">Zend_Measure_*</code> classes provide a generic and easy way for working with measurements. Using
        <code class="code">Zend_Measure_*</code> classes, you can convert measurements into different units of the same type. They
        can be added, subtracted and compared against each other. From a given input made in the user's native language,
        the unit of measurement can be automatically extracted. Numerous units of measurement are supported.
    </p>
<div class="example">
<a name="zend.measure.introduction.example-1"></a><p class="title"><b>Example 28.1. Converting measurements</b></p>
<div class="example-contents">
<p>
            The following introductory example shows automatic conversion of units of measurement. To convert a
            measurement, its value and its type have to be known. The value can be an integer, a float, or even a string
            containing a number. Conversions are only possible for units of the same type (mass, area, temperature,
            velocity, etc.), not between types.
        </p>
<pre class="programlisting">&lt;?php
require_once 'Zend/Measure/Length.php';

$locale = new Zend_Locale('en');
$unit = new Zend_Measure_Length(100, Zend_Measure_Length::METER, $locale);

// Convert meters to yards
echo $unit-&gt;convertTo(Zend_Measure_Length::YARD);
        </pre>
</div>
</div>
<br class="example-break"><p>
        <code class="code">Zend_Measure_*</code> includes support for many different units of measurement. The units of measurement
        all have a unified notation: <code class="code">Zend_Measure_&lt;TYPE&gt;::NAME_OF_UNIT</code>, where &lt;TYPE&gt;
        corresponds to a well-known physical or numerical property. . Every unit of measurement consists of a conversion
        factor and a display unit. A detailed list can be found in the chapter
        <a href="zend.measure.types.html" title="28.5. Types of measurements"><code class="code">Types of measurements</code>
        </a>
        .
    </p>
<div class="example">
<a name="zend.measure.introduction.example-2"></a><p class="title"><b>Example 28.2. The <code class="code">meter</code> measurement</b></p>
<div class="example-contents">
<p>
            The <code class="code">meter</code> is used for measuring lengths, so its type constant can be found in the
            <code class="code">Length</code> class. To refer to this unit of measurement, the notation <code class="code">Length::METER</code>
            must be used. The display unit is <code class="code">m</code>.
        </p>
<pre class="programlisting">&lt;?php
require_once 'Zend/Measure/Length.php';

echo Zend_Measure_Length::STANDARD;  // outputs 'Length::METER'
echo Zend_Measure_Length::KILOMETER; // outputs 'Length::KILOMETER'

$unit = new Zend_Measure_Length(100,'METER');
echo $unit;
// outputs '100 m'
        </pre>
</div>
</div>
<br class="example-break">
</div>
</div>
<div class="navfooter"><table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="zend.mail.read.html">Prev</a> </td>
<td width="20%" align="center"> </td>
<td width="40%" align="right"> <a accesskey="n" href="zend.measure.creation.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">27.14. Reading Mail Messages </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> 28.2. Creation of Measurements</td>
</tr>
</table></div>
<div class="revinfo"></div>
</body>
</html>
